JxBrowser/com.teamdev.jxbrowser.js/[jvm]JsPromise

JsPromise

interface JsPromise : JsObject, Closeable

A JavaScript Promise.

Allows using Java code as promise handlers. The Promise object is alive while the web page where it was created is loaded. When the web page is unloaded, all the JavaScript objects are disposed. An attempt to access the already disposed JavaScript Promise will lead to the IllegalStateException.

Usage example:


    JsPromise jsPromise = frame.executeJavaScript("Promise.resolve('Resolved')");
    jsPromise.then(results -> System.out.println(results[0]));

Functions

call

abstract fun <T> call(methodName: String, args: Array<Any>): T

Executes the function with the given methodName and the args in the JavaScript object.

catchError

abstract fun catchError(onRejected: JsPromiseHandler): JsPromise

Registers a rejection handler for this promise and returns a new one.

abstract fun close()

Closes this JavaScript object.

abstract fun close()

finallyExecute

abstract fun finallyExecute(onFinally: JsPromiseHandler): JsPromise

Registers a handler that will be invoked if the promise is settled (fulfilled/rejected) and returns a new promise.

frame

abstract fun frame(): Frame

Returns the Frame instance of this JavaScript object.

hasProperty

abstract fun hasProperty(name: String): Boolean

Checks whether this JavaScript object or any of its prototypes has an enumerable property with the given name.

isClosed

abstract fun isClosed(): Boolean

Returns true if the current object is closed.

ownPropertyNames

abstract fun ownPropertyNames(): List<String>

Returns an immutable list of the names of the properties of this JavaScript object, both enumerable and non-enumerable, excluding the properties from the prototype objects.

property

abstract fun <T> property(name: String): Optional<T>

Returns an Optional describing the value of the JavaScript object's property with the given name or an empty Optional if there is no such property or its value is undefined.

propertyNames

abstract fun propertyNames(): List<String>

Returns an immutable list of the names of the enumerable properties of this JavaScript object, including the properties from the prototype objects.

putProperty

abstract fun putProperty(name: String, @Nullable value: Any): Boolean

Creates a new property with the given name or updates the existing one in the current JavaScript object and returns true if the property with the given name was created or updated successfully.

removeProperty

abstract fun removeProperty(name: String): Boolean

Removes a property with the given name in the JavaScript object and returns


true

if the property was successfully removed.

then

abstract fun then(onFulfilled: JsPromiseHandler): JsPromise

Registers a fulfillment handler for this promise and returns a new one.

abstract fun then(onFulfilled: JsPromiseHandler, onRejected: JsPromiseHandler): JsPromise

Registers fulfillment and rejection handlers for this promise and returns a new one.